###Function###
FileOpen

###Description###
ffnet eine Datei zum Lesen oder Schreiben.

###Syntax###
FileOpen ( "filename" [, mode = 0] ) 

###Parameters###
@@ParamTable@@
filename
	Dateiname der zu ffnenden Datei.
mode
	[optional] Modus in dem die Datei geffnet werden soll.
	Kann auch eine Kombination aus folgenden sein: 
		$FO_READ (0) = Lesemodus (Standard)
		$FO_APPEND (1) = Schreibmodus (anhngend an das Dateiende)
		$FO_OVERWRITE (2) = Schreibmodus (lschen des vorherigen Inhaltes)
		$FO_CREATEPATH (8) = Anlegen der Verzeichnisstruktur, wenn sie nicht existiert (siehe Bemerkungen).
		$FO_BINARY (16) = Erzwinge den Binrmodus (Siehe Bemerkungen)
		$FO_UNICODE or $FO_UTF16_LE (32) = Verwende Unicode-UTF16 mit Little-Endian-Kodierung im Lese- und Schreibmodus. Lesen berschreibt ein existierendes BOM nicht.
		$FO_UTF16_BE (64) = Verwende Unicode-UTF16 mit Big-Endian-Kodierung im Lese- und Schreibmodus. Lesen berschreibt ein existierendes BOM nicht.
		$FO_UTF8 (128) = Verwende Unicode-UTF8 Kodierung im Lese- und Schreibmodus. Lesen berschreibt ein existierendes BOM nicht.
		$FO_UTF8_NOBOM (256) = Verwende Unicode-UTF8 (ohne BOM) im Lese- und Schreibmodus.
		$FO_UTF8_FULL (16384) = Wenn zum Lesen geffnet wird und kein BOM verfgbar ist, so wird auf die komplette Datei UTF8 Erkennung angewendet. Falls dies nicht verwendet wird, so wird nur der Anfang der Datei nach UTF8 untersucht.
	Der Verzeichnispfad muss bereits vorhanden sein (auer <i>mode</i> $FO_CREATEPATH wird verwendet - siehe Bemerkungen).
	Diese Konstanten werden in der FileConstants.au3 definiert.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Ein Handle auf die Datei, das fr die folgenden Funktionen bentigt wird.
Fehler:	-1, wenn ein Fehler aufgetaucht ist.
@@End@@


###Remarks###<ul>
<li>Das Dateihandle muss mit der <a href="FileClose.htm">FileClose()</a> Funktion wieder geschlossen werden.</li>
<li>Das ffnen einer Datei kann mglicherweise fehlschlagen, durch fehlende Zugriffsrechte oder Attribute.</li>
<li>Der Standardmodus beim Schreiben von Text ist ANSI. Um dies zu ndern ist das Unicode-Flag zu verwenden. Wenn Unicode-Dateien geschrieben werden, so ist der Windows Standardmodus (und der schnellste in AutoIt durch die krzliche Umstellung) UTF16 Little Endian (mode 32).</li>
<li>Wird eine Datei im Schreibmodus (write mode) geffnet, so wird die Datei erstellt, falls sie noch nicht existiert. Verzeichnisse werden nicht erstellt, auer das entsprechende Flag wird verwendet.</li>
<li>Falls mit dem gleichen Dateihandle gelesen und geschrieben wird, so muss die <a href="FileSetPos.htm">FileSetPos()</a> Funktion verwendet werden um die aktuelle Dateiposition zu aktualisieren.</li>
<li>Eine Datei kann binr (byteweise) ausgelesen werden wenn <a href="FileOpen.htm">FileOpen()</a> mit dem Binrflag aufgerufen wird.</li>
</ul>

Siehe <a href="../intro/unicode.htm">"Unicode Support"</a> fr eine detailierte Beschreibung.

###Related###
FileClose, FileFlush, FileRead, FileReadLine, FileWrite, FileWriteLine, FileGetPos, FileSetPos


###Example###
@@IncludeExample@@
